openSUSE:WebYaST Style Guide/Text
Text Style Guide
General
- Keep the text short and meaningful.
Capitalization
Use title style for titles (e.g. headings, module titles) and sentence style for all other UI elements:
- Sentence stlye: first letter of the sentence is capitalized, all others lower case (with the exceptions of proper nouns and acronyms)
- Title style: the first letter of each word is capitalized, the rest are lower case. In some cases short articles, prepositions, and conjunctions are not capitalized unless they are the first word in the title. E.g.
- Articles (a, an, the)
- Coordinate conjunctions (and, but, for, nor, or)
- Prepositions of four or fewer letters
When capitalizing, do not change the capitalization of filenames, configuration variables, and similar casesensitive items. These should be presented in the case required by the system to avoid confusion.
Punctuation
Do not use spaces before commas (,), periods (.), colons (:), or semicolons (;). Avoid using exclamation marks at all. The wording and the type of message provide the needed emphasis. Avoid using punctuation dashes, called em dashes. If it cannot be avoided, use . Only use / if it is part of a standard term, such as TCP/IP. Usually or or and should be used where a / is used.
Spelling
Use American English as the original language for all texts. Many words have multiple "acceptable" spellings, but it has been necessary for SuSE and Novell to standardize on certain variants for consistency. Use the first variant in Webster's dictionary as the standard spelling for anything not on these lists.
|
|
|
Module Title
Use title style for the module title.
Keep the title short and meaningful.
The module title is consistent with the module title in „Show all“ or "Home" page.
Do not use "Configure" or any other verb in the title.
If the module is used to configure a client, use the word "Client" in the title.
If the module is used to configure a server, use the word "Server" in the title.